package com.zapi.ai.service;

import com.zapi.ai.model.ChatMessage;
import com.zapi.ai.model.entity.AiChatHistory;
import java.util.List;

/**
 * AI聊天历史服务接口
 */
public interface AiChatHistoryService {
    
    /**
     * 保存聊天消息
     */
    void saveMessage(String userId, String sessionId, ChatMessage message, String model, Integer tokens);
    
    /**
     * 获取用户的聊天历史（最近的会话）
     */
    List<ChatMessage> getUserHistory(String userId, int limit);
    
    /**
     * 获取指定会话的历史
     */
    List<ChatMessage> getSessionHistory(String sessionId);
    
    /**
     * 清除会话历史
     */
    void clearSessionHistory(String sessionId);
    
    /**
     * 清除用户所有历史
     */
    void clearUserHistory(String userId);
}

